VeEnrres 


FUNCTION: 


Writes files from video cassette tape to disk. Allows you to restore 
file-oriented disk backup from video cassette to disk, 


HINTS/RESTRICTIONS: 


Used in combination with VCRSAV (to write disk files to the video 
cassette tape) and VCRDIR (to display a list of files contained ona 
video cassette). Only reads tapes that were created using the VCRSAV 
command. Not for transferring data between Alpha Micro and non-Alpha 
Micro computers. 


When you enter VCRRES, you will be reminded that VCRRES will liock out 
the other users on your system. You should check with other users on 
your system before proceeding with VCRRES. If another user should be 
readìing from or writing to the disk when you enter VCRRES, you both 
could be ltocked up. 


You may not 'topy to a disk account if it 1s not in the project you are 
copying from unless you are logged into the system operator's account, 
(1,2). If you are logged into (1,23, the default output account 
specification is (13, and if the account you are copying to does not 
exist, VCRRES creates it. You may copy files into the account you are 
logged into from any other account, regardless of project number. 


VCRRES 1S a wildcard command. (See the AMOS User's Guide, 
DWM-00100-35, for information on using wildcard commands.) 


The input specification must give the exact specification of the files 
you want to transfer from the video cassette, including device and 
account specifications of the files as they were written to the tape. 
The output specification allows you to specify the device and account 
the files are to be written to on the disk, and to rename the files as 
they are written out to the disk. 


NOTE: If the cassette you are restoring files from contains a warm boot 
monitor as well as data files, VCRRES skips over the warm boot monitor, 
ignoring it, and goes on with the normal file restore process. 


FORMAT: 
-VCRRES(/switch}{out spec}ì={insnec1{/switch}{,inspec2{/switch}...}} 
where /switch specifies a VCRRES option, outspec specifies the files to 
be created on the disk, and inspec specifies the files to be 
transferred from the video cassette (including the disk device and 


account specifications originally associated with the files when they 
were backed up onto the cassette by VCRSAV.) 
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DEFAULTS: 


You may give an input specification for the files that you Wish to 
restore, or you may let the input specification default to the device 
and account that you are Logged into by entering VCRRES 
{Outfilespec}=#.* and a RETURN. 


The output specification defaults to the input specification in the 
case of the filename and extension. This means that, unless you tell 
it differently, VCRRES will restore the files to the account that you 
are logged into. Therefore, if you want to restore to different 
accounts, you must specify the accounts to be written to, or use 
ALLCUI. 


If you do not specify a device (such as DSKO:), the default will be the 
disk that you are currently logged into. This means that if you are 
logged into DSKO:, everything on the tape will be written onto DSKO:, 
even if they were written to the tape from other disks. 


Therefore, be careful to specify an output specification if the files 
on the tape came from more than one disk. Untess, of course, you want 
to transfer them all onto one disk. 


If you are togged into the System Operator's account, (1,2), the 
default output specification 1s LI. 


The default switches are /NOQUERY, /DELETE, and /NOHASH. 

OPTIONS: 
Use the switches below to select VCRRES options. Each switch must begin 
vith a slash. Remember that the placement of the switch in the command 


line modifies its effect. 


/QUERY or /Q Ask user for confirmation before selecting files 
(file switch). 


INOQUERY or /N0Q Don't ask for confirmation before selecting 
files (default, file switch). 


{DELETE or /D Copy over to an existing file, thus deleting it 
(default, file switch). 


/NODELETE or /NOD Don't copy over to an existing file (file 
switch). 


/ HASH or /} Restore only files that have different hash 
totals on the disk (file switch). (The VCRSAV 
/HASH switch must have been used when you 
originally saved these files on the cassette.) 


ANOHASH or /NOH bon't check hash totals (default, file switch). 
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OPERATION: 


1. 


Type VCRRES followed by the optional output specifications. Then 
type an equal sign followed by any input specifications. Type a 
RETURN. The output specification assigns the specifications of the 
new files you are creating; the input specification selects the 
files to be copied. For example, to copy from a cassette all .PRG 
files that were originally backed up from account [110,2] on DSK2: 
over to your current account, enter: 


»+VCRRES =DSK2:*.PRG[110,2] 


You may specify wildcard file specifications to VCRRES (as in the 
input specification *.PRG above): 


.VCRRES #*.0LDCI=DSK3:*.MACC10,4]/QUERY 


Now VCRRES gives you step-by-step directions for the restore 
process: 


Place cassette at load point. 
Press RETURN on CRT when ready. 


Press PLAY on VCR. 
Press RETURN on CRT when ready. 


Reading Table of Contents from VCR 


Place cassette at load point. 
Press RETURN on CRT «when ready. 


Now VCRRES displays a list of the files on the cassette that fit 
the specifications you entered earlier. If you used the /QUERY 
switch, VCRRES waits after the appropriate statement for you to 
respond Y for yes or N for no. You don°t have to hit RETURN. For 
example: 


VCRO:DSK3:NEW.MACC10,3)] to DSK2:NEW.0LDC10,3) ? Y 
VCRO:DSK3:B32.MACC10,43 to DSK2:B32.0LD[10,4) ? Y 

VORO: DSK3:SCRTCH.MAC[10,61] to DSK2:SCRTCH.0LDC10,6] ? N 
Total of 2 files in 78 btocks selected for transfer. 


After this is done, VCRRES is ready to begin the actual restore 
process: 


Press PLAY on VCR. 
Press RETURN on CRT when ready. 


Bypassing Table of Contents 
BEAINNINOA COPY 0.0. 
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ERRORS: 


IMPORTANT NOTE: You may enter a Control-C at any time to stop the 
file transfer. But remember, some of your current files will have 
been erased from the disk. 


Place cassette at load point. 
Press RETURN on CRT when ready. 


Restoring DSK3:NEW.MAC 
Restoring DSK3:B32.MAC 
Restoring DSK3:SCRTCH.MAC 


Restore completed 
Frasing 'VCRTOC.IPF! 


It is finished. Now you may rewind and remove the cassette, and 
return it to its storage location. 


?Cannot find DSKO:SCNWLD.SYS[1,41] or MEM:SCNWL.D.SYS 


VCRRES needs this file to be able to process wildcard symbols 
in your file specifications. This message can mean that SCNWLD.SYS 
does not exist or that you do not have enough memory to load the 
file into your partition. 


?2Cannot OPEN Devn: - protection violation 


You tried to copy into an account you are not logged into that 
1s not in the same project as the account you are copying from, and 
you are not logged into [1,2]. Either log into (1,21 or the account 
you want to write into, and try again. 


?Cannot READ Devn: - device does not exist 


You tried to copy to or from a device that is not listed in the 
DEVTBL command in your system initialization command file, does not 
have a driver in account (C1,6) of the Sytem Disk, is o not 
file-structured, or is not mounted. ("Devn:" is the device you 
specified.) 


?Tape is not file-structured 


The tape you are trying to read was not written by VCRSAV. 
VCRRES can only read tapes written by VCRSAV. Check to make sure 
you have mounted the correct tape cassette. 





?Missing output specification 


You omitted the equal sign in the VCRRES command line; VCRRES 
couldn't tell which information was your input specification and 
which was your output specification. 


?More than one output specification 


You may not suppiy more than one output specification. 
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?Files may not be transferred to RES: 
You may only add programs to system memory by using the SYSTEM 
command within your system initialization command file. 


ZNot selected - Destination file already exists 
You tried to copy to an existing file while the /NODELETE 


option was in effect. 


ZNot selected - Destination file has same HASH as source file 

You used the /HASH switch and it found matching hash totals on 
the cassette and the disk. The files are evidentiy identical so no 
transfer is necessary. 


ZNot selected - Source file does not have a calculated HASH total 

You specified the /HASH switch but the cassette does not 
contain a HASH total to compare. You didn't use the /HASKH switch 
when you used the VCRSAV program. 


?You are not logged in under [1,21], can't create fp,pn] 

You cannot copy from an account to a nonexistent account unless 
you are logged into the System Operator's account, (1,21. If you 
copy to a nonexistent account while logged into [1,2], VCRRES will 
create the account for you. 


?0utput MFD is full 

The Master File Directory only has room for 63 entries, The 
transfer in progress would have created a new account, but there is 
not enough room in the MFD. 


2bevice full 
No more room on the disk. 


4Bypassing BADBLK.SYS[1,2) 
% BADBLK.SYS exists to prevent bad blocks 
% on a device from being allocated, and 
% should never be directly accessed. 
You cannot copy the BADBLK.SYS[1,2] file, since this would lead 
to the corruption of the file system. 


ZBypassing VCRTOC.IPF 
% VCRTOC.IPF is the name of the 
% Table-of-contents file from tape, and 
% cannot be directly accessed. 

You cannot copy a file to the disk with the resulting file name 
of VCRTOC.IPF because it would write over the temporary file VCRRES 
1s using to locate files on the tape. 
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CHARACTERISTICS: 


A file-oriented program that transfers files from a video cassette tape 
to the disk. You must specify the account and device that the files 
vere originally backed up from. Allows you to rename the files being 
copied. 


Not for transferring data between Alpha Micro and non-Alpha Micro 
computers, 


Accepts wildcard specifications. Output file specification defaults to 
input file specification for the filename and PPN. The input 
specification defaults to *.* and account and device you are logged 
into. Default switches are /NOQUERY, /DELETE, and /NOHASH. Default 
video cassette tape unit device code is VCRO. 


Both the VCRSAV and the VCRRES programs create a temporary directory 
file named VCRTOC.IPF in the disk and account you are currentiy logged 
into. This file is erased and recreated each time VCRSAV or VCRRES is 
used within the account. If you specify VCRTOC.IPF in an VCRSAV or 
VCRRES command Line, VCRSAV and VCRRES will automatically bypass it. 


(Changed 17 May 1982)* 
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FUNCTION: 


Vrites copies of disk files to video tape cassettes. A file-oriented 
disk backup program. 


HINTS/RESTRICTIONS: 


Used for file oriented disk backup. Writes files to video tape 
cassettes along with their disk device and account specifications. 
Also writes date and time of backup. Used in combination with VCRRES 
(to transfer files from video tape cassettes back to disk) and VCRDIR 
(to list a directory of files on a cassette), For additional 
information on other commands and facilities, refer to the command 
reference sheets for VCRDIR, VCRRES, CRT61710, and WRMGEN. 


When you enter VCRSAV, you will be reminded that VCRSAV will lock out 
the other users on your system. You should check with other users on 
your system before proceeding with VCRSAV. If another user should be 
reading from or writing to the disk when you enter VCRSAV, you both 
could be locked up. 


VCRSAV is a wildcard file command. (See the AMOS User's Guide, 
DWM-00100-35,, for information on wildcard specifications.) 


You may back up files from any disk account onto tape whether or not 
the account is within the project you are logged into. Although VCRSAV 
writes the disk specification of the file to the tape cassette along 
with the file, it does not transfer any password that may be associated 
with that disk account. 


VCRSAV is for file backup only; not for transfer of data between Alpha 
Micro and non-Alpha Micro computer systems. 


Because VCRSAV writes the date and time of backup to the tape, you 
should remember to use the DATE and TIME programs to set the system 
date and time before you use VCRSAV. 


FORMAT: 
«VCRSAV {Filespec1{/switch}} 


where Filespec specifies the files you want to back up onto the video 
cassette, and /switch is an option request, 


DEFAULTS: 
The default file specification is *.* and the account and device you 


are logged into. The default switches are /NOGUERY, /NOHASH, and 
/COPIES:0. 
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OPTIONS: 


The options available with the VCRSAV command are the Query/NoQuery 
switches, the Hash/NoHash switches, the Copies switch, and the Boot 
switch. The placement of the switches within the command Line modifies 
their effect. Remember to put a siash before the switch whenever you 
use it. The defaults are /NOGUERY, /NOHASH, and /COPIES:0. 


/QUERY or /Q Ask user for confirmation before selecting files 
(file switch). 


/NOQUERY or /NOQ bon't ask for confirmation before selecting 
files (default, file switch). 


/HASH or /H Calculate a hash total (file switch). 


/NOHASH — or /NOH Don't calculate a hash total (default, file 
switch). 


/COPIES:n or /C:n Specifies the number of extra copies ‘of each 
block of data to be copied onto a cassette, 
(default is /C:0, operation switch). 


/BOOT or /B Generate a warm boot cassette (operation 
switch). 


NOTE: You can use the /HASH switch to calculate hash totals for 
certain files to identify a particular version of the file. This will 
save time when you use VCRRES to restore files to the disk, because you 
can then specify the /HASH switch to transfer only the files that have 
different hash totals. 


You can use the /BOOT switch to transfer a warm boot monitor to a 
cassette along with the other files. See the CRT610 reference sheet 
for more information on warm boot tapes. 


OPERATION: 


1. Type VCRSAV followed by the specification selecting the files you 
want to back up onto the video cassette; then type a RETURN. For 
example: 


_* VCRSAV MEMO.TXT,SCHDLE.TXTC310,2] {Re 


NOTE: You can save space on a cassette by selecting all the 
sequential files or all the random files you want to save at once. 


è. If you are creating a warm boot monitor on the tape, VCRSAV begins 
asking for information it will place in the cassette label: Volume 
name (maximum of 40 characters); Volume ID (maximum of ten 
characters); Installation (maximum of 30 characters); System 
(maximum of 30 characters); and Creator (maximum of 30 characters). 
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3. VCRSAV then tells you what files it is selecting for transfer: 


DSK2:MEMO.TXT to VCRO:DSK2:MEMO.TXT 
SCHDLE.TXTC[310,2) to VCRO:SCHDLE.TXT[310,2] 


Total of 2 files in 126 blocks selected or transfer 


4. Now VCRSAV gives you step-by-step instructions for the save” 
process: 


Place cassette at load point. 
Press RETURN on CRT when ready. 


Press RECORD on VCR. 
Press RETURN on CRT when ready. 


Beginning copy .. 
5. When VCRSAV 15 finished, you see: 


The transfer is now complete. 
Press STOP on the VCR. 
Total of 6 files in 126 blocks transferred 


6. Press STOP and rewind the cassette. You should then use the CRT610 
command with the /CHECK option to check the cassette, Note that 
you may use a Control-C to halt the transfers at any point. 


See the CRT610 reference sheet for information on the CRT610 
command. 


ERRORS: 


?Cannot find DSKO:SCNWLD.SYSC1,47] or MEM:SCNWL_D.SYS 

VCRSAYV needs this file to be able to process wildcard symbols 
in your file specifications. This message can mean that SCHWLD.SYS 
does not exist or that you do not have enough memory to load the 
file into your partition. 





?Cannot READ Devn: - device does not exist 
?Cannot READ Devn: - device is not mounted 

You tried to copy to or from a device that is not listed in the 
DEVTBL command in your system initialization command file, does not 
have a driver in account (1,6) of the System Disk, or is not 
mounted. (’"Devn:’” is the device you specified.) 


ZField size exceeded. Re-enter. 

While you were entering the label information, you tried to put 
more data into a field than it could hold. Check the maximum length 
of the field, and try again. 
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CHARACTERISTICS: 


VCRSAV is a file-oriented disk backup that allows you to copy disk 
files to video tape cassettes. Not for transferring data between Alpha 
Micro and non-Alpha Micro computer systems. 


Accepts wildcard file specifications. Default specification is *.* and 
the device and account you are logged into, The default switches are 
/NOQUERY, /NOHASH, and /COPIES:0. 


Both the VCRSAV and the VCRRES programs create a temporary directory 
file named VCRTOC.IPF in the disk and account you are currently togged 
into. This file is erased and recreated each time VCRSAV or VCRRES is 
used within the account. If you specify VCRTOC.IPF in an VCRSAV or 
VCRRES command Line, VCRSAV and VCRRES will automatically bypass it. 
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